home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / initgroups.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  37 lines
  1.  
  2. INITGROUPS(3)              UNIX Programmer's Manual              INITGROUPS(3)
  3.  
  4. NNAAMMEE
  5.      iinniittggrroouuppss - initialize supplementary group IDs
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<uunniissttdd..hh>>
  9.  
  10.      _i_n_t
  11.      iinniittggrroouuppss(_c_o_n_s_t _c_h_a_r _*_n_a_m_e, _i_n_t _b_a_s_e_g_i_d)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The iinniittggrroouuppss() function uses the getgrouplist(3) function to calculate
  15.      the supplementary group IDs for the user specified in _n_a_m_e. This group
  16.      list then set up for the current process using setgroups(2).  The _b_a_s_e_g_i_d
  17.      is automatically included in the group list.  Typically this value is
  18.      given as the group number from the password file.
  19.  
  20. RREETTUURRNN VVAALLUUEESS
  21.      The iinniittggrroouuppss() function returns -1 if it was not invoked by the super-
  22.      user.
  23.  
  24. SSEEEE AALLSSOO
  25.      setgroups(2),  getgrouplist(3)
  26.  
  27. HHIISSTTOORRYY
  28.      The iinniittggrroouuppss() function appeared in 4.2BSD.
  29.  
  30. BBUUGGSS
  31.      The ggeettggrroouupplliisstt() function called by iinniittggrroouuppss() uses the routines
  32.      based on getgrent(3).  If the invoking program uses any of these rou-
  33.      tines, the group structure will be overwritten in the call to
  34.      iinniittggrroouuppss().
  35.  
  36. 4.2 Berkeley Distribution        June 4, 1993                                1
  37.